home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).adf / KFracPlus / KFracPlus_ENG.doc < prev    next >
Text File  |  1993-09-07  |  13KB  |  401 lines
  1.  
  2.  
  3.                    KFracPlus V3.04
  4.  
  5.                 - FREEWARE -
  6.  
  7.          (c) 1991-93 by Andreas R. Kleinert. All rights reserved.
  8.  
  9.           This program was written under OS V3.00 and is therefore
  10.           fully compatible. It needs OS >= V2.04.
  11.           This program needs :
  12.            - the 'gadtools.library'          V37+ (in "LIBS:")
  13.            - the 'asl.library'               V37+ (in "LIBS:")
  14.            - the 'ak_gen0.libray'            V37+ (in "LIBS:")
  15.            - the 'icon.library'              V33+ (in "LIBS:")
  16.            - the 'mathieeedoubbas.library'   V33+ (in "LIBS:")
  17.            - the 'mathieeedoubtrans.library' V33+ (in "LIBS:").
  18.  
  19.           Full AGA-Support via the AK_GEN0-Screen-Mode-Requester.
  20.  
  21.           Release Date : 20.06.1993
  22.  
  23.  
  24.     Copyright :
  25.     ===========
  26.  
  27.     The program KFracPlus V3.04 and its documentation files are
  28.     (C)opyright 1991-93 by Andreas R. Kleinert. All rights reserved.
  29.  
  30.  
  31.     Disclaimer :
  32.     ============
  33.  
  34.     The author takes no responsibility for any results of the use of this
  35.     program.
  36.     This software is provided "AS IS" and there is no warranty of any kind,
  37.     so that you use this software at your own risk.
  38.  
  39.  
  40.     Distribution :
  41.     ==============
  42.  
  43.     The program KFracPlus V3.04 is freely distributable (FREEWARE).
  44.     You may copy it, if the copyright notice is left intact and
  45.     all of its parts are included in the distribution.
  46.     This program must not be included in commercial packages or commercial
  47.     program collections without my written permission.
  48.     This program must not be sold in any way, but it is allowed to take
  49.     a nominal fee including the costs for copying.
  50.  
  51.     This program may be put on public domain disks or included in public
  52.     domain disk libraries.
  53.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  54.     the german series TAIFUN, FRANZ and TIME.
  55.  
  56.     This program may also be distributed via electronic mail and may be
  57.     put into mailboxes as long as the redistribution conditions are
  58.     respected in all points.
  59.  
  60.     By using or distributing this program you automatically agree to
  61.     all of the above conditions and terms.
  62.  
  63.  
  64.     Intention :
  65.     ===========
  66.  
  67.     Up to this version you have the possibility to generate the
  68.     following types of fractals :
  69.  
  70.      1) Feigenbaum
  71.      2) Julia-Sets
  72.      3) Mandelbrot-Sets ("Apfelmännchen")
  73.  
  74.  
  75.     Usage :
  76.     =======
  77.  
  78.     Julia-Set :
  79.     -----------
  80.  
  81.      'ze_re' and 'ze_im' determine, which part of the fractal,
  82.      which results out of the 'c_re' and the 'c_im' value, is
  83.      shown.
  84.      'ze_re' influences the X-Coordinates, 'z_im' the Y-Coordinates.
  85.      The 'Iteration' value determines the depth - the 'clearness' -
  86.      of the picture, and the 'width' and 'height' are responsible
  87.      for the size of the picture.
  88.      Speed may be increased by selecting less colors, a smaller size
  89.      or less 'Iterations'.
  90.  
  91.     Mandelbrot-Set :
  92.     ----------------
  93.  
  94.      'c_re' and 'c_im' determine, which part of the fractal,
  95.      which is always similarily, is shown.
  96.      'c_re' influences the X-Coordinates, 'c_im' the Y-Coordinates.
  97.  
  98.      The Rest is the same as with the Julia-Set.
  99.  
  100.     Feigenbaum :
  101.     ------------
  102.  
  103.      This implementation does not seem to be fully bug-free, but with
  104.      the default-values it works !
  105.  
  106.  
  107.     Tooltypes and File-Keywords :
  108.     =============================
  109.  
  110.     Tooltypes "neutralize" File-Keywords.
  111.  
  112.  
  113.     SCREEN_MODE=<0x........>            Mode-ID (Hex-Number like in "C")
  114.     SCREEN_WIDTH=<Screen-Width>         (depending on Screen-Mode)
  115.     SCREEN_HEIGHT=<Screen-Height>        (depending on Screen-Mode)
  116.     SCREEN_DEPTH=<Screen-Depth>         Colordepth of the Screens
  117.  
  118.     WINDOW_WIDTH=<Window-Width>         Width and Height of the Display-
  119.     WINDOW_HEIGHT=<Window-Height>        Window on the Screen
  120.  
  121.  
  122.     FEIGENBAUM_KMIN=<Double-Number>        (described above)
  123.     FEIGENBAUM_KMAX=<Double-Number>
  124.     FEIGENBAUM_Q0=<Double-Number>
  125.     FEIGENBAUM_VALS=<Integer-Number>
  126.     FEIGENBAUM_SKIP=<Integer-Number>
  127.  
  128.     MANDELBROT_C_REMIN=<Double-Number>        (described above)
  129.     MANDELBROT_C_REMAX=<Double-Number>
  130.     MANDELBROT_C_IMMIN=<Double-Number>
  131.     MANDELBROT_C_IMMAX=<Double-Number>
  132.     MANDELBROT_STEPWIDTH=<Integer-Number>
  133.  
  134.     JULIA_Z_REMIN=<Double-Number>        (described above)
  135.     JULIA_Z_REMAX=<Double-Number>
  136.     JULIA_Z_IMMIN=<Double-Number>
  137.     JULIA_Z_IMMAX=<Double-Number>
  138.     JULIA_C_RE=<Double-Number>
  139.     JULIA_C_IM=<Double-Number>
  140.     JULIA_STEPWIDTH=<Integer-Number>
  141.  
  142.     SELECTED=<FEIGENBAUM | MANDELBROT | JULIA>      selected Fraktal-Type
  143.  
  144.  
  145.     Correspondence :
  146.     ================
  147.  
  148.     If you like, you may send me some money. Perhaps this will motivate me
  149.     to continue programming such programs or just making updates of
  150.     this one. Send bug-reports, suggestions, money (!) or whatever to :
  151.  
  152.        Andreas R. Kleinert,
  153.        Grube Hohe Grethe 23,
  154.        D-57074 Siegen,
  155.        Germany.
  156.  
  157.  
  158.     Construction :
  159.     ==============
  160.  
  161.     The graphical surface of this program has been created under use of
  162.     the famous program "GadToolsBox V1.4", which is written and
  163.     (C) by Jan van den Baard.
  164.  
  165.     KFracPlus makes use of :
  166.  
  167.        - the 'gadtools.library'          V37+ (Workbench V2.04+)
  168.        - the 'asl.library'               V37+ (Workbench V2.04+)
  169.        - the 'ak_gen0.libray'            V37+ (FREEWARE, by me)
  170.        - the 'icon.library'              V33+ (Workbench V1.2+)
  171.        - the 'mathieeedoubbas.library'   V33+ (Workbench V1.2+)
  172.        - the 'mathieeedoubtrans.library' V33+ (Workbench V1.2+)
  173.  
  174.     KFracPlus has been written in SAS/C V6.00 under OS V3.00.
  175.  
  176.     The first versions of KFracPlus have been written between
  177.     July 1991 and April 1992.
  178.     Those versions were still called only "KFrac" - without this "Plus".
  179.     They were partially developed during a 'project week' at the G.A.L.
  180.     (Gymnasium am Löhrtor) in Siegen. Thanks to all, who gave me the
  181.     knowledge to write the first version of this program and to fix
  182.     its (many) bugs !!!
  183.     Explicitely thanks go to Mr. Schnell, Steffen Dingel and
  184.     René Koch, who organized our project about 'chaos : fractals and their
  185.     meanings' !
  186.  
  187.  
  188.     Turbo-Version ???
  189.     -----------------
  190.  
  191.     This program already uses the Standard-Math-Libraries, which
  192.     support the 68881/2-Coprocessors, but if you are interested in
  193.     a special 68020/68881/2-Turbo-Version, you may contact me !
  194.  
  195.  
  196.    Background :
  197.    ============
  198.  
  199.      About the Mandelbrot- and Julia-Set :
  200.      -------------------------------------
  201.  
  202.      Mandelbrot and Julia are both some ways of a partially display
  203.      of an object, which depends on 4 parameters.
  204.  
  205.      Mandelbrot uses fix 'z_re' and 'z_im' and displays the fractal
  206.      as a graphic, where the x- and y-position depend from 'c_re'
  207.      and 'c_im'.
  208.  
  209.      Julia uses fix 'c_re' and 'c_im' and displays the fractal
  210.      as a graphic, where the x- and y-position depend from 'z_re'
  211.      and 'z_im'.
  212.  
  213.      Both use the same (recursive) algorithm, which looks as
  214.      follows :
  215.  
  216.       z_n+1 = z_new = z_n^2 - c
  217.  
  218.      This is transferred to a 'complex platform', where z_n and c
  219.      are complex (imaginary) numbers :
  220.  
  221.       z_re_new = z_re^2 - z_im^2 - c_re    (new real part for iteration)
  222.       z_im_new = 2*z_re*z_im - c_im       (new imaginary part for iteration)
  223.  
  224.      With this formula it is possible to describe the behaviour of
  225.      the above recursive algorithm in a 2-dimensional way, where
  226.      'convergency' and 'divergeny' (don't know if these are the right
  227.      words) are represented and marked with different colors (each
  228.      pixel).
  229.  
  230.  
  231.     History :
  232.     =========
  233.  
  234.      V3.04 : (20.06.1993, original-size : 41372 Bytes
  235.      -------        and (68020-Version) : 41224 Bytes)
  236.  
  237.       - "crash-bug" fixed
  238.       - remembering values when switching fractal-type
  239.       - Load-/Save-Option
  240.       - more failure-checks and error-requester
  241.       - Window is now cleared before Feigenbaum-Zoom
  242.       - Icon is written (Default-Tool depending on program version)
  243.       - Tooltype-Support
  244.  
  245.  
  246.      V3.03 : (April 1993, original-size : 26884 Bytes
  247.      -------        and (68020-Version) : 26712 Bytes)
  248.  
  249.       - now with special "68020+"-Version
  250.  
  251.  
  252.      V3.02 : (March 1993, original size : 26884 Bytes)
  253.      -------
  254.  
  255.       - use of SAS/C V6.00
  256.       - another fix of the OS V3.0-IDCMP_CLOSEWINDOW-gadtools.library-Bug
  257.     (use "==" instead of "&" to check this bit !)
  258.       - changes to the doc-file
  259.       - use of "ak_gen0.library" V37+ and of its new ScreenMode-Requester,
  260.     so that now ALL available ScreenModes (Std., ECS, AA) are useable
  261.       - made use of some global optimizations (calcing- and IFF-ILBM
  262.     routines)
  263.  
  264.  
  265.      V3.01 : (March 1993, original size : 28716 Bytes)
  266.      -------
  267.  
  268.       - fixed bug in Screen-Requester :
  269.     forgot to convert "depth" into "number of colors"
  270.       - new Icon
  271.       - WB-Console-Window will be closed.
  272.     Side effect : If no Intuition-based error-report is possible,
  273.     you'll get none (because no CLI available).
  274.       - now checking legality of values for window-width and -height
  275.       - there was a small bug in the setting-routine for the ColorDepth-
  276.     Slider-Gadget. Under OS V2.04 there only occured wrong values,
  277.     but under OS V3.0 the whole surface disappeared !
  278.     This bug is now hopefully fixed !!!
  279.       - now runs as a Background-Task (using "cback.o")
  280.  
  281.  
  282.      V3.00 : (February 1993)
  283.      -------
  284.  
  285.       - complete redesign of surface in general :
  286.  
  287.      - new Start-Panel, from which all other areas (Settings, Actions)
  288.        can be reached
  289.      - new OnLine-Panel
  290.      - and more
  291.  
  292.       - separate Screens for Interaction and Drawing
  293.       - ScreenMode-Requester, which allows to select between the following
  294.     modes (non- and interlaced) :
  295.  
  296.      - Lores      (max. 32 Colors)
  297.      - Hires      (max. 16 Colors)
  298.      - Superhires      (max.  4 Colors)
  299.      - Productivity   (max.  4 Colors)
  300.      - VGA-Lores      (max.  4 Colors)
  301.      - VGA-ExtraLores (max.  4 Colors)
  302.      - A2024      (max.  4 Colors)
  303.  
  304.      There may be more modes supported in the future.
  305.  
  306.       - removed CCRT and CRNG things in IFF-Support (neither necessary nor
  307.     useful there)
  308.       - more intensive use of "V37+"-Functions
  309.       - Last not least : "ak_gen0.library" V36+
  310.     (with new FileRequester abilities and less bugs ...)
  311.       - and more ... !!!
  312.  
  313.  
  314.      V2.01 :
  315.      -------
  316.  
  317.       - Interlace did not work. Now it does.
  318.       - Last not least : "ak_gen0.library" V35.106+.
  319.  
  320.  
  321.      V2.00 :
  322.      -------
  323.  
  324.       - now under use of Jan van den Baard's famous program
  325.  
  326.     "GadToolsBox" (V1.4)
  327.  
  328.     and therefore only runable under OS V2.04+
  329.       - Fixed some bad garbage in Mandelbrot-routine (divergency-test)
  330.       - IFF-Support-routine now is more general (internal thing)
  331.       - removed stupid "symmetry" things of former versions (Julia, Mandelbrot)
  332.       - lowest accepted version of "ak_gen0.library" now is V35+
  333.       - cleared DocFile
  334.       - removed "Quadranian"
  335.       - make use of some special OS V2.04-stuff
  336.  
  337.  
  338.      V1.12 :
  339.      -------
  340.  
  341.       - This version is no longer PUBLIC DOMAIN, but FREEWARE
  342.       - now its possible to save the Fractals as IFF-ILBM-Graphics
  343.     (uncompressed and compressed, as you like)
  344.       - some small speed improvements (Yeeeaaaahh !!! :)
  345.       - added some Menus (to the Display-Screen), so that Intuition
  346.     now is supported much more better
  347.       - fixed some things in the docs (this one you are reading now) and
  348.     in the program-internal docs
  349.       - this release makes use of "ak_gen0.library" V35.21
  350.     (V34.xx still supported)
  351.  
  352.      V1.10 :
  353.      -------
  354.  
  355.       - improved and "debugged" the documentation in- and outside the program
  356.       - integrated three new types of fractals :
  357.  
  358.       - Mandelbrot (also called "Apfelmaennchen")
  359.       - Feigenbaum (hope, it functions correctly)
  360.       - Quadranian (it bases on rectangles, and produces a strange kind of
  361.             pattern -> not one of the 'usual' fractals)
  362.  
  363.       - improved some less important things
  364.  
  365.  
  366.      V1.02 :
  367.      -------
  368.  
  369.       - improved speed of main algorithmus
  370.       - making use of pragmas
  371.       - making use of special code optimizations
  372.       - some other small enhancements
  373.       - now the number of colors used is changeable (2, 4, 8, 16)
  374.  
  375.  
  376.      V1.01 :
  377.      -------
  378.  
  379.       - modified for use with "ak_gen0.library" (instead of "ak.library")
  380.       - now support of double precision instead of single precision
  381.  
  382.  
  383.      V1.00 :
  384.      -------
  385.  
  386.       - initial release
  387.  
  388.  
  389.      pre V1.00 :
  390.      -----------
  391.  
  392.       - unreleased work versions
  393.     (constructed mainly during a 'project week')
  394.  
  395.  
  396.     Copyrights :
  397.     ============
  398.  
  399.     Some of the mentioned names or products above may be copyrighted by
  400.     companies or trademarks of companies.
  401.